home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmlookupindomarchive.z.z / pmlookupindomarchive.z / pmlookupindomarchive
Text File  |  1997-04-03  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPIIIINNNNDDDDOOOOMMMMAAAARRRRCCCCHHHHIIIIVVVVEEEE((((3333))))                                PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPIIIINNNNDDDDOOOOMMMMAAAARRRRCCCCHHHHIIIIVVVVEEEE((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee - translate an instance name into an instance
  10.      identifier
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  14.  
  15.      iiiinnnntttt ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm,,,, cccchhhhaaaarrrr ****nnnnaaaammmmeeee))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Provided the current Performance Metrics Application Programming
  21.      Interface (PMAPI) context, is associated with an archive log,
  22.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee will scan the union of all the instance domain
  23.      metadata for the instance domain _i_n_d_o_m, locate the first instance with
  24.      the external identification given by _n_a_m_e, and return the internal
  25.      instance identifier.
  26.  
  27.      This routine is an specialized version of the more general PMAPI routine
  28.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm.
  29.  
  30.      Only the leading non-space characters of _n_a_m_e will be used to identify
  31.      the instance.
  32.  
  33.      The value for the instance domain _i_n_d_o_m is typically extracted from a
  34.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  35.      performance metric.
  36.  
  37.      ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee will return a positive instance identifier on
  38.      success.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee(3), ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3), ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm(3) and
  42.      ppppmmmmNNNNaaaammmmeeeeIIIInnnnDDDDoooommmmAAAArrrrcccchhhhiiiivvvveeee(3).
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      PPPPMMMM____EEEERRRRRRRR____NNNNOOOOTTTTAAAARRRRCCCCHHHHIIIIVVVVEEEE
  46.           the current PMAPI context is not associated with an archive log
  47.  
  48.      PPPPMMMM____EEEERRRRRRRR____IIIINNNNDDDDOOOOMMMM____LLLLOOOOGGGG
  49.           _i_n_d_o_m is not a defined instance domain identifier for the archive
  50.           log
  51.  
  52.      PPPPMMMM____EEEERRRRRRRR____IIIINNNNSSSSTTTT____LLLLOOOOGGGG
  53.           the external instance _n_a_m_e is not known for the instance domain
  54.           _i_n_d_o_m in the archive log
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.